前言

通过设定 Quieter 文章头部的相关参数，实现文章的个性化。

正文

基本参数

参数	描述
title	标题
date	日期（格式：年-月-日时-分-秒）
tags	标签
categories	分类
cover	封面
description	简介信息

示例：

title: Quieter 文章配置
date: 2024-11-14 09:08:00
tags:
  - Hexo
  - 帮助文档
categories: 文档
cover: /images/covers/Quieter 文章配置.webp
description: Quieter 主题的配置文章的参数。

高级参数

封面外挂 CSS

Quieter 支持自定义封面图片的 CSS，通过 cover_style 参数实现，对于本文封面的超框效果，设定的头部文件如下：

cover_style: "height: 131.78%; position: absolute; top: 0; left: 0; transform: translateY(-24.11%);"

效果如下：

当然，这个效果也需要封面图片配合才能做到。

顶部封面

可以通过 top_img 属性设置文字顶部的封面，值可以为多个，每次打开页面时将从中随机选取一张：

top_img:
  - imgs/01.webp
  - imgs/02.webp
  - imgs/03.webp

侧边栏

可以通过设置 asdie 属性，设定文档侧边栏的显示/隐藏（默认为显示）。

aside: false

系列标签

通过设定 series 属性，将在侧边栏显示同样标签的其它文章。示例如下：

tags:
  - Hexo
  - 帮助文档
series: 帮助文档

请注意：series 中出现的标签必须在 tags 中存在！

写作相关

这部分的参数在 Quieter 文章写作 | Hexo-Theme-Quieter 中已经介绍，下面作一个汇总表：

参数	类型	描述	默认值
fancybox	bool	是否打开 fancybox。	`true`
photoFigcaption	bool	是否在图片下方显示图片描述（描述文本为图片的 `alt` 内容）。	`false`
math	bool	是否渲染数学公式。	`false`
mermaid	bool	是否开启 Mermaid（适配 hexo-filter-mermaid-diagrams 插件）。	`false`
APlayer	bool	是否开启 APlayer（适配 hexo-tag-aplayer 插件）。	`false`
AES	bool	是否对文章片段进行 AES 加密。	`false`
gallery	bool	是否使用瀑布流相册。	`false`
highlight_shrink	bool	是否收缩代码块（参考自 Butterfly）	`false`
highlight_height_limit	string	控制代码块最大显示长度，超出部分以滚动条的形式显示（示例：`480px`）。	`auto`

为了保证网页的性能，请不要打开文章中未用到的功能！

文章加密

Quieter 对 hexo-blog-encrypt 加密插件做了适配优化，当文章被加密后，文章主界面将显示上锁标记。同时，解决了文章解密后 js 失效的问题。

password: mikemessi
abstract: Here's something encrypted, password is required to continue reading.
message: Hey, password is required here.
wrong_pass_message: Oh, this is an invalid password. Check and try again, please.
wrong_hash_message: Oh, these decrypted content cannot be verified, but you can still have a look.

文章置顶

Quieter 主题对 hexo-generator-index-pin-top 进行了适配，如果想给某个文章置顶（设置优先级），可以设置：

top: 1

评论系统

如果评论功能已经配置好，默认文章是打开评论系统的，如果不想要在某个文章中开启评论，可以设置：

comments: false

子页面

如果在文章同名的文件夹下放置一个 .md 文件，则 Quieter 可视其为子页面并在面包糠导航栏上体现。

子页面建议在使用 hexo-hide-posts 插件设置隐藏，使其在主页不显示：

hidden: true

下面是一个子页面的示例：

子页面

Hexo 有时候不会正确地渲染子页面，多试几次吧。

代码注入

参考自 Butterfly。如果需要在文章头部/底部注入（js/css）的话，可以通过设置 inject 属性来实现：

inject: 
  head:
    - <link rel="stylesheet" type="text/css" href="XXX.css">
    - <script src="XXX.js"></script>
  button:
    - <link rel="stylesheet" type="text/css" href="XXX.css">
    - <script src="XXX.js"></script>

下面是一个引入 chat.css 的示例：

<link rel="stylesheet" type="text/css" href="/css/chat.css">

你好！

圣光会制裁你！

前言

正文